﻿<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
<title>SetFileTime</title>
<meta http-equiv="Content-Type" Content="text/html; charset=utf-8">
<link rel="stylesheet" type="text/css" href="../../styles/styles.css">
<script language="javascript" src='../links.js' type="text/javascript"></script>
</head>
<body>

<h1>SetFileTime</h1>
<div class=navbar>
<a href="../index.html">главная</a> |
<a href="../structures/index.html">структуры</a> |
<a href="index.html">win32 структуры</a>
</div>

<div class=shortdescr>
Функция <code>SetFileTime</code> устанавливает дату и время создания,
модификации и последнего доступа к файлу.</div>

<pre class=syntax>
BOOL SetFileTime(
  HANDLE hFile,
  CONST FILETIME *lpCreationTime,
  CONST FILETIME *lpLastAccessTime,
  CONST FILETIME *lpLastWriteTime
);
</pre>

<h3>Параметры</h3>
<div class=descr>

    <div class=dfn>hFile</div>
    <div class=dfndescr>идентифицирует файл, для которого устанавливаются дата и время. Файловый дескриптор должен быть создан с доступом <code>GENERIC_WRITE</code> к файлу.</div>
    <div class=dfn>lpCreationTime</div>
    <div class=dfndescr>указывает на структуру типа <a href="filetime.html">FILETIME</a>, которая содержит дату и время создания файла. Значение этого параметра может быть равно <code>NULL</code>, если приложению не требуется эта информация.</div>
    <div class=dfn>lpLastAccessTime</div>
    <div class=dfndescr>указывает на структуру типа <a href="filetime.html">FILETIME</a>, которая содержит дату и время последнего доступа к файлу. Время последнего доступа включает в себя время, когда в последний раз: в файл записывалась информация, читалась информация из файла, или, в случае исполняемых файлов, файл запускался на исполнение. Значение этого параметра может быть равно <code>NULL</code>, если приложению не требуется эта информация.</div>
    <div class=dfn>lpLastWriteTime</div>
    <div class=dfndescr>указывает на структуру типа <a href="filetime.html">FILETIME</a>, которая содержит дату и время последней записи в файл. Значение этого параметра может быть равно <code>NULL</code>, если приложению не требуется эта информация.</div>

</div>

<h3>Возвращаемое значение</h3>
<div class=descr>
  <p>В случае успеха возвращается ненулевое значение.<br>
  Если функция завершается неудачно, возвращается ноль.
  Для получения дополнительной информации вызывайте функцию <code>GetLastError</code>.</p>
</div>

<h3>Замечания</h3>
<div class=descr>
  <p>Файловые системы FAT и NTFS поддерживают время создания файла,
  время последнего доступа к файлу и время последней записи в файл.</p>

   <p>Точность, с которой сохраняются значения времени для файлов, зависит
от используемой операционной системы, файловой системы, сетевой конфигурации.
Подробнее см.  замечания к структуре <a href="filetime.html#precise">FILETIME</a>.</p>

  <p class=note><img src="../../images/note.gif" alt="Замечание для FAT" width="10" height="10"> FAT</p>
  <UL class=note><LI>
   Точность значения времени для файла в файловой системе FAT - 2
секунды. Точность значения времени для файлов в других файловых
системах, например, на сетевых дисках, зависит от файловой системы, но
также может быть ограничена удалённым устройством.
  </LI></UL>

</div>

<h3>Пример</h3>
<div class=descr>
Следующий пример показывает, как установить дату/время модификации файла в значение текущего системного времени.

  <pre class=code>BOOL SetFileToCurrentTime(HANDLE hFile)
{
  FILETIME ft;
  SYSTEMTIME st;

  GetSystemTime(&amp;st);                 // получить текущее время
  SystemTimeToFileTime(&amp;st, &amp;ft);     // преобразовать в файловый формат
  return SetFileTime(hFile,           // установить дату/время модификации файла
              (LPFILETIME) NULL, (LPFILETIME) NULL, &amp;ft);
}
</pre>
</div>


<div class=see>Смотрите также:</div>
<div class=seecont>
<a href="filetime.html">FILETIME</a>,
<a class="msdocs">GetFileSize</a>,
<a href="getfiletime.html">GetFileTime</a>,
<a class="msdocs">GetFileType</a>
</div>

</body>
</html>
